Erase Method

The Erase method deletes all of the graphics and annotations within a graphic window, but does not destroy the window itself. This method is only available on the window object. All other properties of the window object remain unchanged after the erase.

Note: After this method is called, any references to graphics objects will be invalid, and should not be used. The only graphics object that will remain valid is the window itself.

Example

 

p1 = PLOT(/TEST)

 

; Retrieve the plot's window object

w = p1.WINDOW

 

; Note that p1 will no longer be valid

w.Erase

 

; Add a new plot to the same window

p2 = PLOT(/TEST, /CURRENT)

Syntax

window.Erase [, COLOR=color]

Arguments

None

Keywords

COLOR

Set this keyword to a string or RGB vector giving the window's background color. Setting this keyword is equivalent to setting the BACKGROUND_COLOR property on the window object. If this keyword is not set then the window's current color is unchanged.

Version History

8.2

Introduced

See Also

Close Method, Show Method, GETWINDOWS, WINDOW